<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><!-- InstanceBegin template="/Templates/doc.dwt" codeOutsideHTMLIsLocked="false" -->
<head>
<!-- InstanceBeginEditable name="meta" -->
<meta name="Keywords"    content="易软,开源,Bug管理,BugFree,php" />
<meta name="Description" content="BugFree快速使用入门" />
<meta name="site"        content="http://www.1zsoft.com" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- InstanceEndEditable -->
<style type="text/css">
body
{
  font-family: "Tahoma,Arial,Courier";
  font-size: 9pt;
  color: #000000;
  background-color: #EFEFEF;
  line-height:20px;
}
.Border
{
    margin-left:   10px;
    margin-right:  10px;
    margin-top:    10px;
    margin-bottom: 10px;
    padding:       5px;
    border: 1px solid #999999;
}
h3
{
    color:blue;
}
dt
{
    margin-left:    20px;
    margin-top:     5px;
    margin-bottom:  5px;
    font-weight:bold;
}
</style>
<!-- InstanceBeginEditable name="doctitle" -->
<title>易软开源|BugFree快速使用入门(HOWTO)</title>
<!-- InstanceEndEditable --> 
</head>
<body>
<div class="Border"> 
  <a href="http://bugfree.1zsoft.com" target="_blank"><img src="http://bugfree.1zsoft.com/Images/LogoBugFree.gif" alt="BugFree" border="0" /></a> 
  <!-- InstanceBeginEditable name="author" -->
  <h1 align="center">BugFree快速使用入门</h1>
  <div align="center"> <strong>作者： 刘振飞 Email: liuzf at pku dot org dot cn</strong></div>
  <!-- InstanceEndEditable -->
  
  <div align="right"> 
    版本：<!-- InstanceBeginEditable name="id" -->$Id: HOWTO.htm,v 1.5 2005/08/11 15:32:29 wwccss Exp $<!-- InstanceEndEditable --><br />
    本文档地址（点击查看最新）： <!-- InstanceBeginEditable name="source" --> <a href="http://bugfree.1zsoft.com/Doc/HOWTO.htm" target="_blank">http://bugfree.1zsoft.com/Doc/HOWTO.htm</a> 
    <!-- InstanceEndEditable --> </div>
  
  <!-- InstanceBeginEditable name="digest" -->
  <p>摘要：本文旨在介绍如何使用BugFree，这是一个比较简单的版本，比较详细的说明陆续推出。</p>
  <!-- InstanceEndEditable -->
  
  <!-- InstanceBeginEditable name="keywords" -->
  <p>关键词：BugFree,开源,使用说明,项目,查询,解决,关闭,Resove,Fixed</p>
  <!-- InstanceEndEditable -->
  
  <!-- InstanceBeginEditable name="menu" -->
  <!-- InstanceEndEditable -->
  
  <!-- InstanceBeginEditable name="content" -->
	<div>假定你把BugFree安装在 http://www.yourcom.com/BugFree</div>

<h3>1. 添加项目及模块 (BugFree的后台管理)</h3>
<ul>
<li>请访问http://www.yourcom.com/BugFree/Admin/index.php，你可以添加一个新的项目，项目文档库和进度文件处请填写该项目(产品)对应的文档及进度链接，可以为空。</li>
<li>一个项目添加后，可以为该项目“添加模块”，一个项目可以有多个模块，每个模块又可以分为多个子模块。</li>
<li>作为示例，BugFree中缺省建立了“BugFree”项目，其中包含了很多模块。</li>
</ul>    

<h3>2. Bug管理</h3>
请访问http://www.yourcom.com/BugFree，你就可以看到BugFree的真面目了。
<ul>
  <li>
    2.1 左侧栏
    <ul>
      <li>2.1.1 切换查询和创建</li>
        <ul>
          <li>2.1.1.1 查询模式：你可以设定不同的查询条件，寻找你想找的Bug们。</li>
          <li>2.1.1.2 创建 Bug：新建一个Bug，是Bug生命的开始。注意你必须要选定该Bug对应的模块。
              填写完相关的Bug说明后，点击“创建 Bug”按钮即宣告一个Bug的诞生。
          </li>
        </ul>
      <li>2.1.2 项目及其模块的列表：你选择不同的项目，系统会自动列出其下属的模块。</li>
      <li>2.1.3 项目文档和项目进度分别对应BugFree的后台管理中添加的两个链接。</li>
      <li>2.1.4 最近5个指派给我的 Bug：此处列出分派给你的最近五个没有被关闭(终止生命)的Bug。</li>
      <li>2.1.5 最近5个由我创建的 Bug：此处列出你最近新建的五个没有被关闭(终止生命)的Bug。</li>
      <li>2.1.6 我自定义的查询条件：你可以在【Query Bug (查询Bug)】中把查询条件起个名字永久保留起来，这里将会显示出所有你个人定义的查询条件。</li>
    </ul>
  </li>

  <li>
    2.2 右侧栏
    <dl>
      <dt>2.2.1 页面组成</dt>
      <dd>
        一是缺省显示的查询页面，上面显示查询条件、下面显示查询出来的符合条件的Bug们；
        二是点击一个Bug时，右栏显示该Bug的所有信息。
      </dd>
    
      <dt>2.2.2 查询</dt>
      <dd>查询你可以根据自己需要，选择不同的查询条件，比如查找 <br />
          Bug ID(Bug编号)     Smaller Than (小于)     100  
          下面就会倒序显示所有ID号小于100的Bug们。</dd>
      
      <dt>2.2.3 保存查询</dt>
      <dd>
        你也可以选择“Save Query(保存查询)”，给这次定义的查询命名永久保存起来，然后就可
        以在【左栏】的“您自定义的查询条件”中随时使用这个查询。
      </dd>
      
      <dt>2.2.5 一个Bug的处理过程</dt>
      <dd>
      新建一个Bug后，或者查询出符合条件的Bug们点击一个后，【右栏】显示该Bug详细信息。
      在中间的四个Action按钮，你可以：
        <dl>
          <dt>2.2.5.1 Edit(编辑)</dt>
          <dd>该动作允许你改动这个Bug所有可以改动的信息。最常见的是把这个Bug指派给(Assign To)某同事，同时在描述信息中加上你的新注释。</dd>
          
          <dt>2.2.5.2 Resolve(解决)</dt>
          <dd>
            一个Bug有7种解法：
            <ul>
              <li>By Design - 就是这么设计的，无效的Bug</li>
              <li>Duplicate - 这个问题别人已经发现了，重复的Bug</li>
              <li>External  - 是个外部因素(比如浏览器、操作系统、其他第3方软件)造成的问题</li>
              <li>Fixed     - 问题被修理掉了。Tester要尽可能找到这种Bug</li>
              <li>Not Repro - 无法复现你这个问题，无效的Bug</li>
              <li>Postponed - 是个问题，但是目前不必修理了，推迟到以后再解</li>
              <li>Won't Fix - 是个问题，但是不值得修理了，不管它吧</li>
            </ul>
          </dd>
          <dt>2.2.5.3 Close(关闭)</dt>
          <dd>
          当一个Bug被解决之后，如果当初上这个Bug的 Tester同意此解法，则关闭这个Bug。意
          味这个Bug生命周期的终结。</dd>
          
          <dt>2.2.5.4 Activate(激活)</dt>
          <dd>
              如果Tester不同意该Bug的解法，则可激活之。该Bug会自动被指派给当初解决(Resolve)
              的同事，当然你在激活的时候应该写上为什么你这么做，让别人明白你激活它是由道理的。
          </dd>
        </dl>
      </dd>
    </dl>
  </li>
</ul>
<h3>3. BugFree使用过程中常见的问题</h3>
<dl>
  <dt>3.1 不能正确的改变Bug状态</dt>
  <dd>
    一个Bug只有3种状态：Active、Resolved、Closed。实践中经常有不熟悉的同事通过“编辑 (Edit)”来改变所有的状态，那是不合适的。
    正确的状态转换方法应该是：<br />
    <ol>
    <li>某个状态自己到自己的改变，使用“编辑 (Edit)”。比如一个Active的Bug，从一个人指派到另外一个人；</li>
    <li>Active -> Resolved 只能用“解决 (Resolve)”； Resolved -> Closed 只能用“关闭 (Closed)”；</li>
    <li>Resolved -> Active 和 Closed -> Active 只能使用“激活 (Activate)”</li>
    </ol>
  </dd>
  
  <dt>3.2 没有正确的设置项目/模块</dt>
  <dd>上Bug的时候没有选择所属的项目/模块，仅使用缺省的当前项目/模块。</dd>
  
  <dt>3.3 没有正确的设置严重程度</dt>
  <dd>应该明确各项目中严重程度1、2、3、4分别代表哪些类型的缺陷，分门别类去设置。</dd>
  <dt>3.4 不能正确的设置解决方案</dt>
  <dd>解决一个Bug的时候，一共有7种不同的解决方案。需要根据这个Bug的具体情况来设置。</dd>
</dl>
  <!-- InstanceEndEditable -->
</div>

<div class="Border">
文档历史：
<!-- InstanceBeginEditable name="log" -->
<xmp>
$Log: HOWTO.htm,v $
Revision 1.5  2005/08/11 15:32:29  wwccss
 + Add common mistaking use of BugFree

Revision 1.4  2005/06/27 07:23:59  wwccss
 * reduce the history info of document.

</xmp>
<!-- InstanceEndEditable -->
</div>
<div align="center">
  <!-- InstanceBeginEditable name="clickcount" -->
  <script src="http://bugfree.1zsoft.com/ClickCount.php?DocFile=HOWTO.htm"></script>
  <!-- InstanceEndEditable -->
</div>
</body>
<!-- InstanceEnd --></html>